home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / util4 / 0utils.lha / 0Utils / .ReadMe < prev    next >
Text File  |  1995-09-05  |  6KB  |  156 lines
  1.  
  2.             0Utils
  3.           ----------
  4.  
  5. Description:
  6.  
  7.     This archive contains some more or less useful small
  8.     CLI programs with full intermediate source.
  9.     following is a list of the current commands.
  10.  
  11.     BaseName    - remove the suffix from a filename
  12.     CAR        - remove all but the 1st arg
  13.     CDR        - remove the 1st arg
  14.     Close        - close a file opened w/ Open
  15.     Examine     - examine a filesys object
  16.     Exists        - does a specified file exist
  17.     ExpandArgs  - expand all wildcards on cmdline
  18.     FilePart    - get the last part of a filename
  19.     GetWord     - get the nth word in a list
  20.     Open        - Open a file
  21.     PathPart    - get the path part of a filename
  22.     ReadLn        - read from a file opened w/ Open
  23.     ScriptName  - try to get the (temp) name of a scriptfile
  24.     SetOwner    - change ownership of a filesys object (>= v39 needed!)
  25.     SRun        - reinvoke the shell
  26.     SRunSX        - reinvoke the shell, call Execute for scripts
  27.     Suffix        - get the suffix part of a filename
  28.     Tackon        - create a filename from pathpart filepart and suffix
  29.     Touch        - touch files
  30.     VolName     - get the name of the volume (or device) a file is on
  31.     WB_Delete   - delete file and .info (also on WB)
  32.     WriteLn     - write to a file opened w/ Open
  33.     Yes        - output "y" lines
  34.  
  35.     Make_IconXX - patch c:IconX to not only act on scripts
  36.  
  37. Notes:
  38.  
  39.     * No Locale Support (should this be added ?)
  40.     since I thought, that it just would blow the code
  41.  
  42.     * please note, that the commands Open Close, ReadLn and
  43.     WriteLn will break as soon as Amiga gets resource tracking,
  44.     since these commands rely on shared filehandles. (they
  45.     should be used only inside of scripts - better do not use
  46.     them directly, exept U know what U are doing)
  47.  
  48.     * please note that it is possible to get the commandtemplate
  49.     of each of the commands by calling something like
  50.     > strings <cmdname> | search "*$ARG:"
  51.     without invoking it w/ '?' (but that is also possible)
  52.     (pipe is part of '2.04hacks' or builtin for some shells -
  53.     unfortunately I've been told that versioin of pipe might
  54.     be buggy, but there are some other versions on aminet;
  55.     strings is e.g. in my 'filters' collection (or again part
  56.     of some shells)) (it is possible to replace $ARG with any other
  57.     string - just edit gen.c.tplt)
  58.  
  59.     * please note, that all those files are created using a
  60.     template (see compilation) to keep maintenance times
  61.     short and to save space (the .data files are only 1/2 of
  62.     the .c and .doc files).
  63.     The resulting code might be a little bit less efficient,
  64.     than it could be, but I was able to concentrate on the
  65.     main routines of each program, and global addes could be
  66.     performed by changing only one file. However the resulting
  67.     code still is less than 1 kB for most of the executables,
  68.     and I think this is not too much.
  69.  
  70.     * I do _not_ know, why SAS/S does not set the 'PURE'
  71.     bit to the created executables, but I am quite sure, I
  72.     do not use any global variables. However I am not willing
  73.     to stress the tools resident in order to see, if they are
  74.     not residentable, since I do only use them from HD ...
  75.     (if U wanna use them resident, U must ensure this Urself
  76.     or at least send me a request - what has not yet happened)
  77.  
  78. Documentation:
  79.  
  80.     * The docs are _not_ shipped with this archive; however
  81.     You may generate the documentation files via
  82.     > SMake doc
  83.     in the source directory (as long, as U have the recent
  84.     version of 0Parser)
  85.  
  86. Bugs:
  87.  
  88.     * Have a look into .KnownBugs (if it exists)
  89.  
  90.     * Noone can say 'my soft is totally bugfree' unless
  91.     she/he has proven it. If You do find any bug in a file
  92.     of this package, please let me know - my address can
  93.     be found below.
  94.  
  95. History:
  96.  
  97.     * Please have a look into ".History"
  98.  
  99.  
  100. Compilation:
  101.  
  102.     * The .c sources do compile with SAS/C v6.51 (SCOptions &
  103.     SMakefile are part of the archive). The files may also
  104.     compile w/ DICE, but I won't guarantee for that.
  105.     (I have added a gen.dcc.tplt that must be used to create Dice
  106.     compilable sources, since some parts of the gen.sasc.tplt
  107.     are not portable; however the resulting code uses global
  108.     LibBases (protos did not work properly w/ dice 2.07r))
  109.  
  110.     * To create '.c' Sources from '.data' files, U need the
  111.     program '0Parser', which should be part of this archive in
  112.     binary form; if U can not find it there, It can be found on
  113.     my homepage (see below) sorry, but the version of Parser
  114.     distributed w/ XDME source archive is outdated and won't
  115.     fill all needs. Perhaps it is also released as a standalone
  116.     Program in the next days (it seems to be stable now).
  117.     Sorry for the inconvenience.
  118.  
  119.     * The sources make use of an undocumented feature in SAS/C:
  120.     due to the fact, that preprocessor and codegenerator are not
  121.     split, LibraryBases can be redefined after the pragma files
  122.     have been read. Unfortunately that behaviour is a bit limitated
  123.     so we sometimes have to compile with a litte hack: the defines
  124.     FIX_SASPP or FIX_SASOPT enable that, or compile with
  125.     "__USE_SYSBASE" _dis_abled.
  126.  
  127. Author:
  128.  
  129.     My address for bugreports, flames, donations, questions,
  130.     suggestions etc.:
  131.  
  132.     SnailMail:    Bernd Noll
  133.         Brunnenstrasse 55     or    Zu den Eichen 8
  134.         67661 Kaiserslautern        56567 Neuwied
  135.         Germany             Germany
  136.  
  137.     Phone:    *631/55570            *2631/56271
  138.  
  139.     EMail:    b_noll@poker.informatik.uni-kl.de
  140.         noll@alma.student.uni-kl.de
  141.  
  142.     IRC:    `0` (less often persona, Onkel or DieNull)
  143.         (on channel #AmigaGER, #Germany or #PerryRhodan)
  144.         (The backticks around 0 are for IRC does accept
  145.         neither of 0, "0", '0')
  146.  
  147.     WWW:    http://galway.informatik.uni-kl.de/staff/noll/home.html
  148.  
  149. Legal Stuff:
  150.  
  151.     * Please have a look into ".Legal"
  152.  
  153.  
  154. greetings, `0`
  155.  
  156.